home *** CD-ROM | disk | FTP | other *** search
/ IRIX Base Documentation 2002 November / SGI IRIX Base Documentation 2002 November.iso / usr / share / catman / p_man / cat3 / libelf / elf_getarsym.z / elf_getarsym
Encoding:
Text File  |  2002-10-03  |  2.3 KB  |  55 lines
  1. ELF_GETARSYM(3E)                                     Last changed: 10-13-98
  2.  
  3.  
  4. NNAAMMEE
  5.      eellff__ggeettaarrssyymm - Retrieves archive symbol table
  6.  
  7. SSYYNNOOPPSSIISS
  8.      cccc [_f_l_a_g ...] _f_i_l_e ...  --lleellff [_l_i_b_r_a_r_y ...]
  9.  
  10.      ##iinncclluuddee <<lliibbeellff..hh>>
  11.  
  12.      EEllff__AArrssyymm **eellff__ggeettaarrssyymm((EEllff **eellff,, ssiizzee__tt **ppttrr));;
  13.  
  14. IIMMPPLLEEMMEENNTTAATTIIOONN
  15.      IRIX systems
  16.  
  17. DDEESSCCRRIIPPTTIIOONN
  18.      eellff__ggeettaarrssyymm returns a pointer to the archive symbol table, if one is
  19.      available for the ELF descriptor, eellff.  If the archive does not have a
  20.      symbol table, an error occurred, or eellff was null, eellff__ggeettaarrssyymm returns
  21.      a null value.  The symbol table is an array of structures that include
  22.      the following members:
  23.  
  24.      cchhaarr **aass__nnaammee;;
  25.  
  26.      ssiizzee__tt
  27.           aass__ooffff;;
  28.  
  29.      uunnssiiggnneedd lloonngg
  30.           aass__hhaasshh;;
  31.  
  32.      These members have the following semantics:
  33.  
  34.      aass__nnaammee   Contains a pointer to a null-terminated symbol name.
  35.  
  36.      aass__ooffff    This value is a byte offset from the beginning of the
  37.                archive to the member's header.  The archive member residing
  38.                at the given offset defines the associated symbol.  Values
  39.                in aass__ooffff may be passed as arguments to eellff__rraanndd to access
  40.                the desired archive member.
  41.  
  42.      aass__hhaasshh   This is a hash value for the name, as computed by eellff__hhaasshh.
  43.  
  44.      If ppttrr is non-null, the library stores the number of table entries in
  45.      the location to which ppttrr points.  This value is set to zero when the
  46.      return value is null.  The table's last entry, which is included in
  47.      the count, has a null aass__nnaammee, a zero value for aass__ooffff, and ~~00UULL for
  48.      aass__hhaasshh.
  49.  
  50. SSEEEE AALLSSOO
  51.      eellff(3E), eellff__ggeettaarrhhddrr(3E), eellff__hhaasshh(3E), eellff__rraanndd(3E), aarr(4)
  52.  
  53.      This man page is available only online.
  54.  
  55.